/*
 * Copyright © 2018 www.noark.xyz All Rights Reserved.
 *
 * 感谢您选择Noark框架，希望我们的努力能为您提供一个简单、易用、稳定的服务器端框架 ！
 * 除非符合Noark许可协议，否则不得使用该文件，您可以下载许可协议文件：
 *
 *        http://www.noark.xyz/LICENSE
 *
 * 1.未经许可，任何公司及个人不得以任何方式或理由对本框架进行修改、使用和传播;
 * 2.禁止在本项目或任何子项目的基础上发展任何派生版本、修改版本或第三方版本;
 * 3.无论你对源代码做出任何修改和改进，版权都归Noark研发团队所有，我们保留所有权利;
 * 4.凡侵犯Noark版权等知识产权的，必依法追究其法律责任，特此郑重法律声明！
 */
package xyz.noark.network.rpc.stub;

import xyz.noark.core.network.PacketCodec;
import xyz.noark.network.codec.rpc.RpcPacket;

/**
 * RPC存根基类，用于处理RPC调用的响应
 * <p>
 * 存根是RPC调用中的一个关键概念，它作为客户端和服务端之间的桥梁，
 * 负责管理请求-响应的匹配和回调处理。
 * </p>
 *
 * @author 小流氓[176543888@qq.com]
 * @since 3.4.7
 */
public abstract class RpcStub {

    protected final PacketCodec packetCodec;

    /**
     * 构造函数，protected修饰表示只能被子类访问
     */
    protected RpcStub(PacketCodec packetCodec) {
        this.packetCodec = packetCodec;
    }

    /**
     * 处理RPC响应数据包
     * <p>
     * 当RPC服务端返回响应时，会调用此方法来处理响应数据。
     * 根据存根类型（同步或异步）采取不同的处理策略：
     * <ul>
     *   <li>同步存根：唤醒等待线程并传递响应结果</li>
     *   <li>异步存根：触发回调函数处理响应结果</li>
     * </ul>
     * </p>
     *
     * @param packet RPC响应数据包，包含响应数据和元信息
     */
    public abstract void onResponse(RpcPacket packet);
}